home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / acf540r0.zip / ACFSYSOP.DOC < prev    next >
Text File  |  1992-01-18  |  88KB  |  2,323 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.          ┌───────────────────────────────────────────────────────────────────┐
  14.          │          The Auto Control File System - AKA, ACFiles              │
  15.          │                  The Originator of File Tagging                   │
  16.          ├──────────────┬─────────────────────────────────────┬──────────────┤
  17.          │   ▀▀▀▀▀▀▀▀▀▀▀│         ACFiles Version 5.40        │▀▀▀▀▀▀▀▀▀▀▀   │
  18.          │     ▀▀▀▀▀▀▀▀▀│ BBS File System Replacement Utility │▀▀▀▀▀▀▀▀      │
  19.          │        ▀▀▀▀▀▀│    The Best File System Available   │▀▀▀▀▀         │
  20.          │           ▀▀▀│            By: Ray 'C'ole           │▀▀▀           │
  21.          └──────────────┴─────────────────────────────────────┴──────────────┘
  22.  
  23.                                    Documentation By
  24.                                  Ray Cole and Al Hays
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                      Dedication
  31.                                      ──────────
  32.  
  33.          This version  is  dedicated  to  the ACFiles Beta Team, without whose
  34.          many ideas, dedicated support,  and  tireless efforts this version of
  35.          ACFiles would not have been possible, and
  36.  
  37.          To my Father, Ivey Cole, whose constant inspiration  prompted  me  to
  38.          write, release, and continue to improve ACFiles ... and who taught me
  39.          that the  only idea that absolutely "can not be done" is the one that
  40.          has not yet been attempted.
  41.  
  42.          I thank you all, especially you Dad.
  43.  
  44.          - Ray 'C'ole
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                     ACFiles SysOp Documentation - Table of Contents
  65.          ─────────────────────────────────────────────────────────────────────
  66.          Disclaimer, License Agreement, Overview ........................... 3
  67.          Feature Highlights ................................................ 5
  68.          Important Terminology ............................................. 7
  69.          Errorlevels ....................................................... 7
  70.          Requirements ...................................................... 7
  71.          Getting Started ................................................... 8
  72.          ACFCONF.EXE  (ACFiles Configuration Program)
  73.               General Configuration ........................................ 8
  74.               File Area Configuration ..................................... 12
  75.               Node Configuration .......................................... 16
  76.               Protocol Configuration ...................................... 17
  77.                  PROT_LOG.EXE ............................................. 19
  78.          Control Files
  79.               LIMITS.CTL .................................................. 21
  80.               ARC_VIEW.CTL ................................................ 22
  81.               DRIVES.ACF .................................................. 22
  82.               ACFIDX.CTL .................................................. 23
  83.               ACF_MOVE.CTL ................................................ 23
  84.               ACMASTER.CFG ................................................ 23
  85.          Other Setup Considerations
  86.               DSZ/GSZ, DSZLOG ............................................. 24
  87.          Interfacing ACFiles to BBS ....................................... 24
  88.          Batch Files for TOTAL Configurability
  89.               MOVEFILE.BAT ................................................ 25
  90.               COPYFILE.BAT ................................................ 25
  91.               PRE-DOWN.BAT ...................... See Multi-Node Operations
  92.               DROP_DOS.BAT ................................................ 26
  93.               AFTERUP.BAT ................................................. 26
  94.          SysOp Command Menu ............................................... 27
  95.          On-Line SysOp Keys ............................................... 29
  96.          Custom ANSI/ASCII Menu Screens ................................... 30
  97.          Utility Programs ................................................. 31
  98.               ACMAINT.EXE ................................................. 31
  99.               ACMASTER.EXE ................................................ 31
  100.               ACF_UPL.EXE ................................................. 31
  101.               ACFIDX.EXE .................................................. 32
  102.               FD2ACF.EXE .................................................. 32
  103.               ACF_ADD.EXE ................................................. 32
  104.               ACF_OPT.EXE ................................................. 32
  105.               ACF_OFF.EXE ................................................. 33
  106.               ACF_RET.EXE ................................................. 33
  107.               NEWDATE.EXE ................................................. 34
  108.               ENTERKEY.EXE ................................................ 34
  109.               LOGUPD.EXE .................................................. 34
  110.          Multi-Node Specific Operations and Utilities ..................... 34
  111.               ACF_MOVE.EXE ................................................ 34
  112.               CLEANDIR.EXE ................................................ 35
  113.               PRE-DOWN.BAT ................................................ 35
  114.          Common Questions and Answers ..................................... 36
  115.          Product Support .................................................. 37
  116.          BETA Site - Support System List .................................. 37
  117.          Registration ..................................................... 39
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.          DISCLAIMER:
  127.          ─────────────────────────────────────────────────────────────────────
  128.          ACFiles is  only  guaranteed  to take up disk space if you have it on
  129.          any type of computer media.  However,  if  you or your system deletes
  130.          it then it is no longer guaranteed to do anything.
  131.  
  132.  
  133.          LICENSE AGREEMENT
  134.          ─────────────────────────────────────────────────────────────────────
  135.          ACFiles ver 5.40 is a shareware product. It may be  freely copied and
  136.          distributed for evaluation as long as:
  137.  
  138.          1)  All  files  and  documentation  are  distributed  intact  and not
  139.              modified in any way,
  140.          2)  A copy of this documentation is provided with the program,
  141.          3)  No charge, other than a media and handling charge when copied,
  142.              is levied when distributing ACFiles, and
  143.          4)  Users of this program purchase a license for its use prior to the
  144.              expiration of the evaluation  period.   A  reasonable  evaluation
  145.              period of  60  days is granted.  All copies  of  ACFiles  in  use
  146.              beyond the  60 day evaluation period must be either registered or
  147.              deleted.
  148.  
  149.          One license per machine is required,  with  the exception of a single
  150.          multi-node BBS operating from a single location via LAN technology.
  151.  
  152.          Please note  that  if you purchased a disk containing  this  software
  153.          from a  public  domain/shareware  software distributor, you have paid
  154.          the media and handling charges  as  permitted  above.   You  have not
  155.          purchased a  license  or  registered this product  with  the  Author.
  156.          Purchasing a  license  and  registering  this product is required for
  157.          continued use beyond the evaluation period.
  158.  
  159.  
  160.           OVERVIEW                                                            
  161.          ─────────────────────────────────────────────────────────────────────
  162.          Auto Control  Files  (ACFiles)  is  a  unique full  File  System  for
  163.          EXITINFO.BBS (RA/QBBS/SBBS)  BBS  systems with a different twist.  It
  164.          has a unique "Quick-Select"  bar  so  that  you  and users can select
  165.          files while viewing a file list.  From there the  user  can  download
  166.          the files  without  having to ever enter a filename.  The Sysop "tag"
  167.          files to do such things as mass  file  movement to other areas, mass-
  168.          deletion, un-hide the file for users, and even edit the description.
  169.  
  170.          While ACFiles  is a nice program for users, you  will  find  it  even
  171.          better from  the  SysOp  side.   The  status bar looks similar to the
  172.          QuickBBS/RA Status bar.  Setting  it  up  is quite easy.  There are a
  173.          variety of  SysOp  commands  available and it even  includes  a  full
  174.          -screen chat brought up with ALT-C by the SysOp.
  175.  
  176.  
  177.  
  178.  
  179.                           ACFiles SysOp Documentation
  180.                                     Page 3
  181.  
  182.  
  183.  
  184.          ACFiles now  incorporates  a  full file indexing system to facilitate
  185.          immediate acquisition of files from even the largest BBS, whether via
  186.          a large hard drive(s), WORM Drives, or multiple CD-ROMS.
  187.  
  188.          ACFiles can  handle up to 260 file areas.  Each one is configured for
  189.          access security, upload area,  configured FILES.BBS path and name (so
  190.          you aren't forced into having it 1 particular way),  area  Name,  and
  191.          even area description.
  192.  
  193.          ACFiles also  has  a  General  Configuration  for the BBS name, SysOp
  194.          level security, screen write  mode  (BIOS  or Direct), whether or not
  195.          you want uploaded files to be hidden from a user,  inactivity timeout
  196.          in seconds, and an Upload Time Credit ratio.
  197.  
  198.          Tired of  the  way  the MOVE commands are?  Well, configure your own!
  199.          ACFiles calls a batch file upon  moving  a  file.   The batch file is
  200.          passed 4  variables  that  allow  you to make it  "smart"  enough  to
  201.          convert to various compression formats, scan for viruses, or whatever
  202.          you want it to do!  Samples are included.
  203.  
  204.          And finally,  ACFiles  is  great for having a "File Section Co-SysOp"
  205.          with all of its powerful commands.  No longer does a Co-Sysop need to
  206.          know your  paths  to  all your  file  areas.   Each  area  is  easily
  207.          identified.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.          
  239.                           ACFiles SysOp Documentation
  240.                                     Page 4
  241.  
  242.  
  243.  
  244.  
  245.          ACFiles Feature Highlights
  246.          ─────────────────────────────────────────────────────────────────────
  247.          * Complied under Borland C++ v2.0
  248.          * Takes less than 180K RAM to run
  249.          * Supports read/write/update to EXITINFO.BBS for RA/QBBS/SBBS
  250.          * Up to 260 File Areas Supported
  251.          * Private files/areas Supported
  252.          * GLOBAL operations sub-menu
  253.          * COMPLETE  CD-ROM  Support  via  indexed  File  Database (FAST!) and
  254.            support for Carousel/Cartridge  Multi-Disk  CD-ROMs  and Multi-node
  255.            usage of Multiple Disk CD-ROMs
  256.          * PREDEFINE Drive Types (HD, CD-ROM, WORM) for Optimal performance
  257.          * Unlimited FREE areas
  258.          * Complete On-Line user Help
  259.          * FILE LISTING - ACFiles the Originator of File Tagging:
  260.            - File tagging for Ansi *AND* ASCII users
  261.            - Stop/Pause/Continue file listing for tagging, viewing, etc.
  262.            - Home/End keys available for File listings
  263.            - Users may view PREVIOUS PAGE while listing files
  264.            - All Archive manipulation commands available during listings
  265.            - VERBOSE/EXTENDED description support for File Listings
  266.            - External  ANSI  Full  Screen editor support for  VERBOSE/EXTENDED
  267.              descriptions (QuickED, TopED), Internal Line editor included.
  268.          * Logoff after upload
  269.          * Full Carrier detection - No Watchdog or CTTY required
  270.          * QuickBBS/RA style Status Bar display
  271.          * Configurable Keyboard inactivity timeout
  272.          * INTERNAL Split Screen Chat with word wrap
  273.          * ADVANCED SysOp Features include:
  274.            - ALL SysOp commands available to SysOp REMOTELY
  275.            - CONFIGURABLE Shell to DOS
  276.            - Sysop may return caller to BBS, send Garbage, or Drop Carrier
  277.            - SysOp may obtain RAW Dir listing of *ANY* path
  278.            - SysOp may Download/Upload from/to *ANY* Path
  279.            - Sysop configurable Upload credit multiplier
  280.            - SysOp configurable upload directories for each file area
  281.            - SysOp defined viewing of Upload "By-lines" by security level
  282.            - SysOp may configure level of "forced entry" for U/L descriptions
  283.            - SysOp may MOVE, EDIT, DELETE, etc. "Tagged" Files quickly
  284.            - Sysop may permanently edit user SecLev/Flags from within ACFiles
  285.            - Internal FILES.BBS Maintenance
  286.            - # days to keep file configurable to purge OLD files automatically
  287.          * ADVANCED ONLINE Archive manipulation:
  288.            - MULTIPLE file extension support for up to 10 Archive types
  289.            - View/Read Textfiles from within archive on-line
  290.            - Remove specific files for Download into custom packet
  291.            - Build a custom packet into ANY user-named, user-specified archive
  292.              format for download ONLINE!  ZIP <==> ARJ, etc.
  293.          * Virus Scan, Comment and reARC upload files to any archive
  294.            Format using AFTERUL.BAT ... POWERFUL, FLEXIBLE, CONFIGURABLE!
  295.          * EXTENSION INSENTIVE Dupe checking for defined ARC formats
  296.          * FULL Configuration Program for system customization
  297.          * FULL external protocol support
  298.  
  299.                           ACFiles SysOp Documentation
  300.                                     Page 5
  301.  
  302.  
  303.  
  304.          * FULL ratio enforcement via LIMITS.CTL support
  305.          * FULL security check by Flags and Security level
  306.          * Scans ONLY areas where user has access
  307.          * Batch Transfer Support
  308.          * Wildcard Support for file searches AND Transfers
  309.          * FULL Multinode Support
  310.          * Detects and Displays IntraNode Messages
  311.          * New file search from user specified date
  312.          * On-line or Off-line Files Counter support
  313.          * Configurable ASCII/ANSI Menus in Registered Version
  314.          * Still only $15.00 USD for non-commercial registrations
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                           ACFiles SysOp Documentation
  360.                                     Page 6
  361.  
  362.  
  363.  
  364.  
  365.          IMPORTANT TERMINOLOGY
  366.          ─────────────────────────────────────────────────────────────────────
  367.          Even if  you think you know all the terminology of a file system, I'd
  368.          suggest you read this to keep  you  from  getting  confused.  Some of
  369.          these may be new to you:
  370.  
  371.          Area Tag: This is a short 2-key code for a file area.  It consists of
  372.                    the key  combination  pressed  to get  to  the  area.   For
  373.                    example, B5 would refer to Set B, Number 5.  Area tags will
  374.                    be displayed  at  the top of each area in ACFCONF.  Anytime
  375.                    you see something asking for an Area Tag, it is NOT a path.
  376.                    Throw that idea out  of your mind and think about each area
  377.                    being assigned a specific tag and *NOT* a path.
  378.  
  379.          Tagged File: This refers to a file that has been  "tagged"  using the
  380.                       selection bar  in  the  file  listing.  Tagged files can
  381.                       have many things done with them upon your command.
  382.  
  383.          FILES.BBS: This is the filename used by QuickBBS and other systems to
  384.                     refer to a file consisting  of  the  filenames  and  short
  385.                     descriptions of the files in a particular  file  area.   I
  386.                     will refer   to  those  lists  as  FILES.BBS's.   However,
  387.                     ACFiles does not  force  you  to  name  it this.  It is an
  388.                     ASCII file with the filename beginning in column 1 and the
  389.                     file description beginning in column 14.
  390.  
  391.  
  392.  
  393.  
  394.          MISCELLANEOUS ITEMS AND REQUIREMENTS
  395.          ─────────────────────────────────────────────────────────────────────
  396.          ErrorLevels: Upon exit, ACFiles exits with the following errorlevels:
  397.  
  398.                       0 - Exit Program (Normal)
  399.                       1 - General Error (File Not Found, Etc.)
  400.                       2 - Carrier Dropped
  401.                       3 - Time Up For User
  402.                       4 - Fossil Init Failure
  403.                       6 - Inactivity Timeout
  404.  
  405.  
  406.  
  407.  
  408.  
  409.          Requirements:
  410.  
  411.          IBM or   compatible  computer  running  Dos  3.X   and   later.    An
  412.          EXITINFO.BBS (QBBS/RA/SBBS)  style BBS and the achivers (up to 10) of
  413.          your choice.  It may be possible,  through  the  use  of a "Door Type
  414.          Conversion Utility",  to run ACFiles on other types  of  BBS  Systems
  415.          although this has not yet been tested.  I would be interested to hear
  416.          if you do this.
  417.  
  418.  
  419.                           ACFiles SysOp Documentation
  420.                                     Page 7
  421.  
  422.  
  423.  
  424.  
  425.  
  426.          STARTING OUT
  427.          ─────────────────────────────────────────────────────────────────────
  428.  
  429.          ACFiles setup in a NUTSHELL:
  430.  
  431.          1)  Run ACFCONF according to the instructions below.
  432.          2)  Insure that all necessary CONTROL files are in place
  433.          3)  Customize any BATCHFILES that you wish
  434.          4)  Interface it to the BBS
  435.  
  436.  
  437.  
  438.                                 ! ! ! IMPORTANT ! ! !
  439.          ****** ANSI.SYS MUST BE INSTALLED FOR ACFILES TO RUN CORRECTLY ******
  440.  
  441.  
  442.  
  443.  
  444.          Place all  of  the  ACFiles  files into their own sub directory.  Run
  445.          ACFCONF.EXE.  You will notice  a  selection of either General or Area
  446.          configuration.  Select G first.
  447.  
  448.  
  449.  
  450.  
  451.          You will now see this screen:
  452.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  453.          1)               BBS Name:
  454.          2)             Desc Files:
  455.          3)             SysOp Sec.:
  456.          4)           Screen Write:
  457.          5)         UpLoads Hidden:
  458.          6)     Inactivity Timeout: Secs
  459.          7)      Upload Time Ratio: Times
  460.          8)        Auto-D/L File 1:
  461.  
  462.          9)        Auto-D/L File 2:
  463.  
  464.          0)          BBS Path     :
  465.          A)      Menu Twirl Prompt:
  466.          B) On-Line Counter Update:
  467.          C)   ANSI External Editor:
  468.          E)        Free Download K:
  469.          F) UL Drive Space Check K:
  470.          G) Show UL By Information:
  471.          H) Forced Pre-Upload Info:
  472.          I)             SysOp Name:
  473.  
  474.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  475.          Selection:
  476.  
  477.  
  478.  
  479.                           ACFiles SysOp Documentation
  480.                                     Page 8
  481.  
  482.  
  483.  
  484.  
  485.          Let's Cover the general setup area:
  486.  
  487.          1) BBS Name:
  488.  
  489.          Enter the  name that you wish ACFiles to display as the BBS's name on
  490.          all menus.  NOTE:  The BBS name  will  appear  as  UNREGISTERED  COPY
  491.          until registration.
  492.  
  493.          2) Desc Files:
  494.  
  495.          The path to the Extended Description directory. i.e. C:\ACFILES\DESC\
  496.          This is   the  area  where  ACFiles  will  maintain   Extended   File
  497.          descriptions.  NOTE:   If this area is UNDEFINED the Verbose/Extended
  498.          description feature will be DISABLED.
  499.  
  500.          3) SysOp Sec.
  501.  
  502.          The SysOp access security level.   This  is the level at which a user
  503.          will be  able  to access the advanced SysOp features  via  the  SysOp
  504.          menu.  It is recommended that this level be set EXTREMELY high.
  505.  
  506.          4) Screen Write:
  507.  
  508.          If you  don't  have  an  old  CGA card that produces Snow with direct
  509.          screen writes, then select (2)  for  Direct  writes.  If this doesn't
  510.          work right for you when ACFiles is run then reset  it  to  (1)  (BIOS
  511.          Writes) which is a bit slower.  If you run under a multi-tasker (like
  512.          Desqview) select  1  (BIOS  Writes).   It  is  possible to use DIRECT
  513.          screen writes under DESQview if VIRTUALIZATION is set ON.
  514.  
  515.          5) Uploads Hidden:
  516.  
  517.          If you want ALL uploaded files  to  be  hidden  from users (Users are
  518.          defined as  those with access lower than the SysOp  security  defined
  519.          above) then  select  (1)  for  YES,  Else  select  (2) for No and all
  520.          uploaded files will appear normally to all using the file system.
  521.  
  522.          6) Inactivity Timeout:
  523.  
  524.          Enter the number of seconds  of  user  inactivity  that  you wish for
  525.          ACFiles to return to the BBS.
  526.  
  527.          7) Upload Time Ratio:
  528.  
  529.          This is the Upload/Time Ratio multiplier and determines how much time
  530.          credit a user gets when they successfully upload  a  file.  For  each
  531.          minute of upload time, the user will receive additional time based on
  532.          this factor.  If  you  specified  (3) here, and the user's successful
  533.          upload took 5 minutes, then ACFiles  would award the user (3*5 mins),
  534.          or 15 minutes of additional time.
  535.  
  536.  
  537.  
  538.  
  539.                           ACFiles SysOp Documentation
  540.                                     Page 9
  541.  
  542.  
  543.  
  544.  
  545.          8-9) Auto-D/L File 1 ( and 2):  (OPTIONAL)
  546.  
  547.          You may optionally assign 2 specific files for availability instantly
  548.          and "auto-download"  by  the  user.  This option assigns keys "1" and
  549.          "2" in the Main Menu to transfer  these  files  without the necessity
  550.          for the user to enter a filename.  The description  is also included.
  551.          This is  useful  so  that the user can download your master file list
  552.          (or other file) without knowing the name.
  553.  
  554.          0) BBS Path:
  555.  
  556.          Enter the MAIN BBS Path where  your BBS .CTL files are maintained and
  557.          where intranode messages are written by the BBS Software.
  558.  
  559.          A) Menu Twirl Prompt:
  560.  
  561.          ACFiles will  display a "twirling prompt" while waiting  for  a  menu
  562.          selection, if  desired.   Select "1" to enable this feature or "2" to
  563.          disable.
  564.  
  565.          B) On-line Counter update:
  566.  
  567.          ACFiles will maintain a "download  counter"  of the number of times a
  568.          file has been downloaded when viewing the file listings.  If you wish
  569.          the download counter to be updated on-line immediately  following all
  570.          downloads, select  "1".  Selecting "2" will disable this feature, but
  571.          you may still update the counter  during  your  daily  maintenance by
  572.          using LOGUPD.EXE if desired.
  573.  
  574.          IF YOU USE BIMODEM:  It is recommended that this  option  be disabled
  575.          and upload counters be updated OFF-LINE.
  576.  
  577.          C) ANSI External Editor:
  578.  
  579.          A Line  editor  is  included  in ACFiles to edit the Verbose/Extended
  580.          descriptions.  If you wish to  use a FULL SCREEN ANSI editor, such as
  581.          QuickED or TopED, specify the FULL PATH and EXECUTABLE  filename here
  582.          to invoke the editor.
  583.  
  584.          E) Free Download K:
  585.  
  586.          Enter the  amount  of  "FREE"  Kb  that  the user may download before
  587.          ratios take effect.  A "0" would  cause  ACFiles  to  enforce  ratios
  588.          beginning with the first byte.
  589.  
  590.          F) UL Drive Space Check:
  591.  
  592.          Enter the minimum amount of Drive Space that MUST be available before
  593.          ACFiles will allow an Upload.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                           ACFiles SysOp Documentation
  600.                                     Page 10
  601.  
  602.  
  603.  
  604.  
  605.          G) Show UL by Information:
  606.  
  607.          Enter the MINIMUM security level to view the "Uploaded By:" line.  To
  608.          disable By-line viewing, enter "0".  This option only affects the "UL
  609.          By" lines created by, and stored in, ACFiles File Database areas.  An
  610.          "UL By"  line may be added to FILES.BBS with an external utility, but
  611.          ACFiles will have no control over the display of this information.
  612.          H) Forced Pre-Upload Info:
  613.  
  614.          One of the problems with Batch  Uploads  is that the user may begin a
  615.          batch upload,  wander  away from the computer,  and  not  be  at  the
  616.          console when the upload finishes.  This is particularly annoying when
  617.          you get  multiple files with no descriptions due to user timeout.  By
  618.          selecting "1", you may force  the  user  to enter the filename before
  619.          beginning an upload, selecting "2" will force the  user to enter BOTH
  620.          the filename   and   description  before  beginning  an  upload,  and
  621.          selecting "0" will not require any advance information.
  622.  
  623.          NOTE:  Upload info will be available  to the user REGARDLESS of which
  624.          option you choose above.  Setting the option to "0"  will  simply not
  625.          FORCE the user to enter the information PRIOR to beginning the UL.
  626.  
  627.          I) SysOp Name:   Your Name
  628.  
  629.  
  630.          This completes  the  GENERAL setup.  Striking <ENTER> will return you
  631.          to the main ACFCONF menu.
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                           ACFiles SysOp Documentation
  660.                                     Page 11
  661.  
  662.  
  663.  
  664.          FILE AREA CONFIGURATION
  665.          ─────────────────────────────────────────────────────────────────────
  666.          Next define your file areas.  Hit A.  You will see this screen
  667.  
  668.  
  669.  
  670.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  671.          Area Tag: A0
  672.          1 - Name: <Deleted>
  673.          2 - Desc:
  674.          3 - Path:
  675.          4 - FILE.BBS:
  676.          5 - Upload Area Tag:
  677.          6 - Sec.: 0
  678.          7 - Type: Public
  679.          8 - Free: No
  680.          9 - Database Name:
  681.          E - Kill After: 0 Days                 A - Flag A: --------
  682.          F - D/L Sec.: 0                        B - Flag B: --------
  683.          G - U/L Sec.: 0                        C - Flag C: --------
  684.          H - Dupe Check: Yes                    D - Flag D: --------
  685.          Regular File Area
  686.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  687.          [+] Next, [-] Previous [J] - Jump to Area [U] - Global U/L Tag Change
  688.          [M] - Move Area  [CR] - Exit
  689.          Enter # To Change:
  690.  
  691.  
  692.  
  693.          The first  area displayed is area "A0".  Each area must be configured
  694.          separately to specify access limits, paths, descriptions, etc.
  695.  
  696.          1 - Name:
  697.  
  698.          Enter the SHORT name of the file  area to be displayed at the ACFiles
  699.          main menu.  i.e. Communications, Bulletin Board, DOS Utils, etc.
  700.  
  701.          2 - Desc:
  702.  
  703.          Enter the file area description that will be displayed at the sub-set
  704.          area menu.  i.e. for the SHORT name "Communications", the description
  705.          might be, "Terminal Programs, Protocols, Etc." on the sub-set menu.
  706.  
  707.          3 - Path:
  708.  
  709.          Enter the FULL PATH to where the files for this area are stored.  The
  710.          PATH, although  important,  is  not critical if the  File  Data  Base
  711.          option is  used  as  ACFiles  will keep a separate index of where the
  712.          files are  located  (see #9 below).   Trailing  backslashes  are  not
  713.          required.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                           ACFiles SysOp Documentation
  720.                                     Page 12
  721.  
  722.  
  723.  
  724.          4 - FILES.BBS:
  725.  
  726.          Enter the FULL PATH and FILENAME of the file area's list. The default
  727.          is the  area's  path  and FILES.BBS as the name for your convenience.
  728.          The FILENAME may be ANYTHING  you  wish.   However,  if you decide to
  729.          name it differently from conventional methods, then the ACFiles utils
  730.          may be the only ones that will correctly identify the list names.  If
  731.          you are new to this or want to be able to use your previous utilities
  732.          then leave it as the <Path>\FILES.BBS.
  733.  
  734.          5 - Upload Area Tag:
  735.  
  736.          THIS IS NOT A PATH NAME!!!!  IT IS AN AREA TAG!  ENTERING A PATH NAME
  737.          OR AN INVALID TAG WILL CAUSE ACFILES TO RETURN YOU TO THE BBS.
  738.  
  739.          ACFiles allows  you to force all uploaded files to  any  specifically
  740.          defined area  when  [U]pload  is  selected by a user from the current
  741.          area you are configuring.  Let's say that you want all uploaded files
  742.          in this area to go to your Uploads  Directory that just happens to be
  743.          area tag  A0  (area  tags  are displayed at the top  of  each  area's
  744.          configuration.  See  above  example.)   You would simply put A0 here.
  745.          This allows you to force uploads into a specific directory.
  746.  
  747.          6 - Sec.:
  748.  
  749.          Enter the MINIMUM Security Level  necessary  for  the  user to access
  750.          this area.  Note  that this area will not even be  displayed  in  the
  751.          menus of  ACFiles if the user's security level is less than the level
  752.          specified in this section.  This includes GLOBAL downloads, searches,
  753.          etc.
  754.  
  755.          7 - Type:
  756.  
  757.          ACFiles allows "Private" uploads  to/from users BY AREA.  If you wish
  758.          this area  to allow PRIVATE uploads, enter "1".   Private  files  are
  759.          only available  to  you,  the  SysOp, and the intended recipient.  No
  760.          other users may DOWNLOAD or VIEW a file marked as Private.
  761.  
  762.          NOTE:  Any user may download  a  "Private"  file  *if*  they know the
  763.          filename.  ACFiles,  however,  WILL NOT display the  name  except  as
  764.          noted above to the intended recipient and the SysOp.
  765.  
  766.          8 - Free:
  767.  
  768.          ACFiles allows  you  to  specify  that all of the files in a specific
  769.          area are "FREE" and not subject  to  ratios.   This  is  particularly
  770.          handy for product support, network coordinators who  wish  to provide
  771.          Nodelists/Nodediffs as  "FREE"  files, etc.  If you wish this area to
  772.          be "FREE" select (1), else selecting  (2) will enforce defined limits
  773.          and ratios.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                           ACFiles SysOp Documentation
  780.                                     Page 13
  781.  
  782.  
  783.  
  784.          9 - Database Name:    (Optional, but highly recommended)*
  785.  
  786.          ACFiles will maintain a Database Index of all files in the area for a
  787.          near-immediate response to search queries, global downloads, etc.  It
  788.          will also  speed  the  file  list display on larger systems.  This is
  789.          particularly helpful for systems  with optical drives like CD-ROMs or
  790.          WORMs and very large hard drives.  If you wish to  make  use  of this
  791.          advanced feature,  specify  a  UNIQUE database name for the area of 8
  792.          characters or less.  This name must be UNIQUE for each file area and
  793.          will be used by ACFIDX to create the area's index.
  794.  
  795.          *NOTE:  VERBOSE/EXTENDED descriptions  are only available if the area
  796.          is a "Database Area" with a corresponding .FDB index  file created by
  797.          ACFIDX.
  798.  
  799.          E - Kill After <#> Days
  800.  
  801.          This field  is  used  by ACMAINT to automatically purge "old" and out
  802.          dated files from your system automatically.   Enter "0" if you do not
  803.          wish ACMAINT  to  perform this feature or if you  wish  to  determine
  804.          which files  are  kept.   A  perfect  example of usage would be for a
  805.          network NODEDIFF area where the  diff  files are automatically purged
  806.          as their age precludes effective usage.
  807.  
  808.          F - D/L Sec.:
  809.  
  810.          Specify the minimum user security level to download  files  from this
  811.          area.  This  WILL NOT affect the users ability to view the file list,
  812.          but ONLY disallows downloads  from  the  area  if the user's security
  813.          level is less than that specified.
  814.  
  815.          G - U/L Sec.:
  816.  
  817.          Same as D/L Sec. but applies to uploads for this area.
  818.  
  819.          H - Dupe Check
  820.  
  821.          If you wish ACFiles to check for duplicate files  BEFORE accepting an
  822.          upload into   this   area,   select   (1).    ACFiles  is  "extension
  823.          insensitive" in it's treatment  of  "dupes"  for  all file extensions
  824.          that have been specified in ARC_VIEW.CTL. For example,  if  the  Dupe
  825.          Check feature  is  enabled and the user attempts to upload MYFILE.ZIP
  826.          and the file MYFILE.ARJ exists, then ACFiles will treat the file as a
  827.          duplicate *IF* both ARJ and ZIP  have  been  defined in ARC_VIEW.CTL.
  828.          MYFILE.TXT, however, would NOT be treated as a duplicate.
  829.  
  830.          [A-D] - Edit Security Flags
  831.  
  832.          This allows you to specify the necessary flags needed  for  a user to
  833.          access these file areas.  All 4 flags sets are supported.
  834.  
  835.          You've now  configured  your  first  file area.  Hit [+] to go to the
  836.          next file area until you have  configured  all the areas you wish for
  837.          your system.  Areas do not have to be contiguous.
  838.  
  839.                           ACFiles SysOp Documentation
  840.                                     Page 14
  841.  
  842.  
  843.  
  844.          You will  also  notice  the  [J] and [U] commands.  [J] allows you to
  845.          Jump To a file area by entering it's tag.  If you wish to go directly
  846.          to area H8 from area A0, select [J] and enter H8.
  847.  
  848.          [U] allows you to globally change  EVERY file area's upload directory
  849.          to 1 area tag.  Use this with care!
  850.  
  851.          Once you  are satisfied with your area configuration,  hit  Enter  to
  852.          save your changes.
  853.  
  854.          Finally, there is an option to [M]ove file area.  This option is VERY
  855.          simple and  you may move an entire file area by simply specifying the
  856.          AREA TAG (i.e. H8) that you wish to move the file area to.
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                           ACFiles SysOp Documentation
  900.                                     Page 15
  901.  
  902.  
  903.  
  904.          NODE CONFIGURATION
  905.          ─────────────────────────────────────────────────────────────────────
  906.          The final  step  of  the ACFiles configuration is Node Configuration.
  907.          This step must be completed  ...  single  node  BBS's  will need only
  908.          complete it once.  Multi-node BBS's will need to  complete  this step
  909.          for each node.
  910.  
  911.          You must  now  execute  a copy of ACFCONF *FROM WITHIN* your main BBS
  912.          directory.                                 ^^^^^^^^^^^
  913.  
  914.          Select [N] to enter the Node Configuration  area.   You will see this
  915.          screen:
  916.  
  917.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                         
  918.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  919.          A)  ACFiles Data Path:
  920.          B)      Log File Name:
  921.          C)        Node Number:
  922.  
  923.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                         
  924.          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  925.          Selection:
  926.          A)  ACFiles Data Path :
  927.  
  928.          Specify the FULL PATH to your ACFiles data files.
  929.  
  930.          B)  Log File Name:
  931.  
  932.          Specify the name of the LOG file for this node.
  933.  
  934.          C)  Node Number:  Specify the Node Number (Whew!)
  935.  
  936.          That's it.   Upon  exiting, insure  that  the  file  ACFNODE.CFG  was
  937.          created by  ACFCONF in your main BBS directory.   Multi-node  systems
  938.          should execute  a  copy  of  ACFCONF  *IN EACH* directory specific to
  939.          *EACH NODE*, following the steps  above  and  insuring  that the file
  940.          ACFNODE.CFG is created in each directory.
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                           ACFiles SysOp Documentation
  960.                                     Page 16
  961.  
  962.  
  963.  
  964.          PROTOCOL CONFIGURATION
  965.          ─────────────────────────────────────────────────────────────────────
  966.          In the  ACFCONF  program  you'll  notice a Protocol editor. For those
  967.          that don't  need anything other  than  what  is  pre-configured  with
  968.          ACFiles, I'd suggest leaving it alone.  However, if you want to add a
  969.          protocol I've tried to make it as easy as possible.
  970.  
  971.          ACFiles calls the external protocols and MUST be  able  to read a log
  972.          file which  IT  creates  telling  what  it  transferred,  if  it  was
  973.          successful, and how many bytes  were  transferred.   For that reason,
  974.          there may be 1 or two external protocols that won't  work alone.  You
  975.          may be  able  to  use  these  protocols with the PROT_LOG.EXE utility
  976.          included with ACFiles (See description/examples below on Page 19-20).
  977.  
  978.          If you have troubles, please send  me  a copy of the protocol you are
  979.          installing and I'll get you a configuration for it.
  980.  
  981.          You'll notice a screen containing "slots" for each external protocol.
  982.          Select the letter of the slot you wish to edit.
  983.  
  984.          It will now ask for the Protocol Name.  This is  how  the  name  will
  985.          appear to  the  user  when  they select the protocol.  This should be
  986.          short.  <ENTER> by itself on the  line will delete the protocol so BE
  987.          CAREFUL not to strike <ENTER> on a line with a Protocol that you wish
  988.          to keep.
  989.  
  990.          Next specify whether this is a batch protocol.  This is for protocols
  991.          like Zmodem that allow multiple files to be transferred.   Answer Yes
  992.          or No accordingly.
  993.  
  994.          Now specify whether this is a two-way protocol ... like Bimodem.  Set
  995.          this to  Yes  if  this  protocol allows receiving and transmitting of
  996.          files at the same time, or No if not.
  997.  
  998.          The next statement is the command  to send a file.  This and the next
  999.          one, command to receive, are explained in detail below.
  1000.  
  1001.          ACFiles will  call  these  lines exactly as entered.   The  following
  1002.          symbols are   special   for  ACFiles  and  causes  it  to  substitute
  1003.          information in place:
  1004.  
  1005.          %1 - Filename(s) to send
  1006.          %2 - Baud Rate
  1007.          %3 - Com Port
  1008.          %4 - File Containing List Of Files To Send
  1009.          %5 - Upload Path
  1010.          %6 - Download Path
  1011.          %7 - Time Left in Minutes
  1012.          %8 - Drive Of Upload Path - Ex.   F:
  1013.          %9 - Path of Upload Path -  Ex.   \IBM\RECEIVE
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                           ACFiles SysOp Documentation
  1020.                                     Page 17
  1021.  
  1022.  
  1023.  
  1024.          Where does %8/%9 come in handy??
  1025.  
  1026.          If you  are  NOT  a  registered DSZ user then you will NOT be able to
  1027.          specify a path for where uploaded  files  go.  Therefore you can call
  1028.          the batch file with the %8 and %9 parameters and do:
  1029.  
  1030.                   %8
  1031.                   cd%9
  1032.  
  1033.          NOTE: Once these parameters are passed to a batch  file  the  numbers
  1034.          will probably  be  reassigned by DOS.  I'd suggest that if you call a
  1035.          batch file (unlike what my examples show..) to *not* call it with ALL
  1036.          9 parameters.  Lengthy PATHNAMES,  etc. can cause the command line to
  1037.          exceed DOS length limitations causing undesirable results.
  1038.  
  1039.  
  1040.          My PROTOCOL.CFG contains this for Xmodem:
  1041.  
  1042.          XMODUP.BAT %3 %2 %1 %8 %9
  1043.  
  1044.               Example File:  XMODUP.BAT
  1045.  
  1046.               @echo off
  1047.               %3
  1048.               cd%4
  1049.               DSZ port %2 estimate 0 %1 rx %5
  1050.  
  1051.  
  1052.               Example File:  XMODDN.BAT
  1053.  
  1054.               @echo off
  1055.               DSZ port %2 estimate 0 %1 sx %3
  1056.  
  1057.          Note that the statements in the batch file change  because  the batch
  1058.          file uses the %'s that you sent and renumbers them from %1 on.  So it
  1059.          is MUCH  easier to just send all %'s to a batch file and that way you
  1060.          don't have to do any conversion.
  1061.  
  1062.          Now we are down to the log file format.  It is explained here:
  1063.  
  1064.          Log File Format:
  1065.  
  1066.          This is the ONLY way that ACFiles will know if a file is sent or not.
  1067.          It will NOT update your counters,  etc.  correctly if this is not set
  1068.          correctly.
  1069.  
  1070.          You must know what type of log entries your external protocol makes.
  1071.  
  1072.          Example of DSZ.LOG:
  1073.  
  1074.          Z 149372   2400 bps  217 cps    0 errors  506 1024 F:\10\21.ZIP -1
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                           ACFiles SysOp Documentation
  1080.                                     Page 18
  1081.  
  1082.  
  1083.  
  1084.          The Log Format statement in PROTOCOL.CFG represents a "format" of the
  1085.          log file's lines.  It has a few flags that represent various things:
  1086.  
  1087.               %s - Status Flag Location
  1088.               %b - Bytes Sent
  1089.               %f - Filename - With or Without a Path
  1090.               %g - Garbage
  1091.  
  1092.          These represent locations.  Spacing between them doesn't matter.  So,
  1093.          for the above log entry, the format would be:
  1094.  
  1095.          %s %b %g %g %g %g %g %g %g %g %f
  1096.  
  1097.          This means  the  first word will be the flags, which are checked with
  1098.          the Sent Good/Received Good flags  defined in Protocol.cfg.  They are
  1099.          case sensitive.
  1100.  
  1101.          The second word is expected to be the # Bytes sent/received. The next
  1102.          8 words are garbage and not needed by ACFiles.  The  11th spot is the
  1103.          filename.  Since the rest of the log entry isn't needed, there are no
  1104.          other "format" flags in the log format line and the rest is ignored.
  1105.          Good Flags:
  1106.  
  1107.          The next  information asked for is what the protocol will put in it's
  1108.          log file for the %f slot if it  is  successful  at transfer.  ACFiles
  1109.          checks these case sensitive.  These are allowed  for  both  send  and
  1110.          receive flags.   Z  in  the log example above would be a Receive good
  1111.          flag.
  1112.  
  1113.          Next is the protocol log name.  THIS IS NOT a log file for you...This
  1114.          is telling ACFiles what the  log  file  name  is  that  the  external
  1115.          protocol creates  for it to read in needed information.   Failure  to
  1116.          have this set right as well as the flags will cause the Byte counters
  1117.          and Download  #  counters  to not be updated..  That is it.  For more
  1118.          information or help, call the support BBS.
  1119.  
  1120.  
  1121.  
  1122.          PROT_LOG.EXE  Protocol Log Maker
  1123.  
  1124.          Makes a log file for ACFiles for  protocols  that only return back an
  1125.          errorlevel.
  1126.  
  1127.                   Usage:  PROT_LOG  PATH\FILENAME   FLAG
  1128.  
  1129.                   Example:
  1130.  
  1131.                   PROT_LOG C:\0\ACFTEST.ZIP  S
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                           ACFiles SysOp Documentation
  1140.                                     Page 19
  1141.  
  1142.  
  1143.  
  1144.                   Output:
  1145.  
  1146.                   PROT.LOG will contain a line in the following format:
  1147.  
  1148.                            Actual:  FILENAME    BYTES    FLAG(Sent/Not)
  1149.                   ACFConf Setting:   %f          %b       %s
  1150.  
  1151.  
  1152.                   FLAG can be whatever character you want.  PROT_LOG will only
  1153.                   write the first letter (case-sensitive) to the log.
  1154.  
  1155.                   Here's an example batch file to use PROT_LOG:
  1156.  
  1157.                   Let's call this protocol "A-Modem":
  1158.  
  1159.  
  1160.                   @echo off
  1161.                   A-MODEM port %2  filename %3
  1162.                   if errorlevel 1 goto bad
  1163.                   :good
  1164.                   prot_log %3 SENT
  1165.                   goto end
  1166.                   :bad
  1167.                   prot_log %3 BAD
  1168.                   :end
  1169.  
  1170.  
  1171.          That's it.    This   assumes  that  %3  in  the  batch  file  is  the
  1172.          path\filename of the file to be sent.  Note that errorlevel protocols
  1173.          can not be batch protocols using  PROT_LOG.  It is the opinion of the
  1174.          author that batch protocols should create a log file  of some sort in
  1175.          order to be widely supported.
  1176.  
  1177.          So, an example upload would be similar:
  1178.  
  1179.                   @echo off
  1180.                   A-MODEM receive port %2 filename %3
  1181.                   if errorlevel 1 goto bad
  1182.                   :good
  1183.                   prot_log %3 RECEIVED
  1184.                   goto end
  1185.                   :bad
  1186.                   prot_log %3 BAD
  1187.                   :end
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.                           ACFiles SysOp Documentation
  1200.                                     Page 20
  1201.  
  1202.  
  1203.  
  1204.          CONTROL FILES
  1205.          ─────────────────────────────────────────────────────────────────────
  1206.          You have  now  completed  configuring  ACFiles.   The next step is to
  1207.          insure that all necessary control  files  are  in place.  LIMITS.CTL,
  1208.          DRIVES.ACF and  ARC_VIEW.CTL  are  the only REQUIRED  control  files.
  1209.          ACFIDX.CTL is  required  ONLY  IF  you  wish to take advantage of the
  1210.          advanced file  database  feature   of   ACFiles   (which   is  highly
  1211.          recommended).
  1212.  
  1213.  
  1214.          LIMITS.CTL
  1215.  
  1216.          K-Byte limits are defined in a file called LIMITS.CTL.   This file is
  1217.          required for  operation  of  QuickBBS/RA/SBBS,  but a review of it is
  1218.          provided here.
  1219.  
  1220.          ACFiles will  look to the MAIN  BBS  directory  (as  defined  in  the
  1221.          General Config setup) for this file.  QBBS/RA/SBBS uses LIMITS.CTL in
  1222.          their daily operation.  The format of LIMITS.CTL is:
  1223.  
  1224.          10    30   250  350  500  500  750  5  10
  1225.          50    45   350  500  750  750 1024 10  20
  1226.          100   60  1024 1024 1024 2048 2048
  1227.          500   90  2048 2048 9999
  1228.          1000 120  9999
  1229.           ^    ^     ^    ^    ^    ^    ^   ^   ^
  1230.           |    |     |    |    |    |    |   |   Kb Ratio
  1231.           |    |     |    |    |    |    |  # Files Ratio
  1232.           |    |     |    |    |    |  9600+ Daily Kb Limit
  1233.           |    |     |    |    |    4800 Daily Kb Limit
  1234.           |    |     |    |    2400 Daily Kb Limit
  1235.           |    |     |    1200 Daily Kb Limit
  1236.           |    |     300 Daily Kb Limit
  1237.           |    Time Limit per day in Minutes
  1238.           Security Level
  1239.  
  1240.          Multiple spaces between entries are ignored.  ACFiles  will read from
  1241.          300 -->  9600 until the end of the line has been read.  If ALL of the
  1242.          entries are not completed for  every  baud  rate, ACFiles will assign
  1243.          the last read baud rate to all higher rates.  In  the  above example,
  1244.          users with  Security  Level  500 will receive 2048Kb daily at 300 and
  1245.          1200 Baud, and 9999Kb at 2400 and above. All Level 1000 users receive
  1246.          9999Kb daily at ALL baud rates.
  1247.  
  1248.          The # Files Ratio and Kb Ratio  are  WHOLE numbers.  A ratio of 10 in
  1249.          the Kb Ratio area will allow the user to download  10  Kb for every 1
  1250.          Kb uploaded.   Similarly, a ratio of 5 in the # FILES area will allow
  1251.          the user to download 5 files  for  every  1 uploaded.  Ratios will be
  1252.          ignored if not included in LIMITS.CTL.  An entry  for 300 *THRU* 9600
  1253.          daily kb  limits  must  be  included  in  LIMITS.CTL  for  ACFiles to
  1254.          properly read/assign ratios.   In  the  example  above, NO RATIOS are
  1255.          assigned to SecLev 100 and above.
  1256.  
  1257.  
  1258.  
  1259.                           ACFiles SysOp Documentation
  1260.                                     Page 21
  1261.  
  1262.  
  1263.  
  1264.          ARC_VIEW.CTL
  1265.  
  1266.          Extension Types  and  Archive  commands are specified in ARC_VIEW.CTL
  1267.          and this ASCII file must reside in the ACFiles master data directory.
  1268.          Up to 10 different extension/archive types may be specified.
  1269.  
  1270.          ARC_VIEW.CTL comes configured  for  ZIP,  ARC, ZOO, PAK, ARJ, and LZH
  1271.          which is the majority of archive types in use on  BBS  systems today.
  1272.          It may  not, therefore, be necessary to change to the file unless you
  1273.          wish to add other archive programs or alter those in existence.
  1274.  
  1275.          Format:  EXT  View_Call              Example:  ZIP  pkzip -v %s
  1276.                        Extract_Call                          pkunzip  %s
  1277.                        Add Call                              pkzip -a %s
  1278.                        Delete Call                           pkzip -d %s
  1279.  
  1280.          %s is the target filename and  is  passed  by  ACFiles to the archive
  1281.          utility when invoked.
  1282.  
  1283.          NOTE:  There are two methods of invoking the archive programs:
  1284.  
  1285.                 RECOMMENDED:  Place all of your archive utilities  in a single
  1286.                 directory and  insure  that  this  directory  is  in  your DOS
  1287.                 "PATH=" statement.
  1288.  
  1289.                 ALTERNATE:  If the archive  utilities  are  not in your system
  1290.                 path then  you  must  specify the FULL PATH  in  the  call  of
  1291.                 ARC_VIEW.CTL:
  1292.  
  1293.                 Example: ZIP  c:\util\pkzip -v %s
  1294.                               c:\util\pkunzip  %s
  1295.                               c:\util\pkzip -a %s
  1296.                               c:\util\pkzip -d %s
  1297.  
  1298.          DRIVES.ACF
  1299.  
  1300.          This ASCII  file  defines  the Drive types of your system for optimal
  1301.          performance.
  1302.  
  1303.                 Drive Types Definitions:
  1304.  
  1305.                 0=Hard Drive (DEFAULT)
  1306.                 1=WORM Drive
  1307.                 2=CD-ROM (Read Only)
  1308.  
  1309.                 Example:
  1310.  
  1311.                 C    0
  1312.                 D    0
  1313.                 E    0
  1314.                 F    0
  1315.                 G    0
  1316.                 H    0
  1317.                 I    2
  1318.  
  1319.                           ACFiles SysOp Documentation
  1320.                                     Page 22
  1321.  
  1322.  
  1323.  
  1324.          ACFIDX.CTL   (Optional, but required for File Database Feature)
  1325.  
  1326.          This file  defines ALL POSSIBLE PATHS (which have not been previously
  1327.          defined in ACFCONF) for the location  of  files that may be contained
  1328.          in your FILES.BBS and is read by ACFIDX.EXE when  creating  the  File
  1329.          Databases.
  1330.  
  1331.          If the  path  has  been  previously  defined  in  the AREAS set-up of
  1332.          ACFCONF, then it is not necessary  to list it in ACFIDX.CTL.  This is
  1333.          specifically designed to support large HD's, CD-ROMs  and WORM drives
  1334.          whose setup  may not include all files to a particular "GROUP" in the
  1335.          same directory, but which you wish to list in a single FILES.BBS.  It
  1336.          also means  that  you  may  list   a  file  in  several  areas  while
  1337.          maintaining only one actual copy of the file on your system.
  1338.  
  1339.          ACFIDX.CTL is an ASCII file, created with you favorite  text  editor.
  1340.          The paths must begin on the first line of the file, each path on it's
  1341.          OWN line, and continue (without any blank lines) until all paths have
  1342.          been listed.  The paths may be listed in any order.
  1343.  
  1344.                 EXAMPLE (PARTIAL ACFIDX.CTL for RBBS In-a-Box V2N3 CD-ROM):
  1345.  
  1346.                 I:\720K
  1347.                 I:\AJUT
  1348.                 I:\BREA
  1349.                 I:\CRAZ
  1350.                 I:\DISC
  1351.                 I:\EQUI
  1352.                 I:\FORD
  1353.                 I:\FWRD
  1354.                 I:\HDNO
  1355.                 I:\INST
  1356.                 I:\ZZAP
  1357.  
  1358.  
  1359.  
  1360.  
  1361.          BCHAT.WIN
  1362.  
  1363.          A One-Line  ASCII  file that defines the window available to the user
  1364.          for SysOp Paging.  Format is in 24 hour (military time) in the format
  1365.          <BeginTime>-<EndTime>.  Example:   0800-2300  would specify 8AM-11PM.
  1366.          If BCHAT.WIN does not exist, 24 hour paging is assumed.
  1367.  
  1368.  
  1369.  
  1370.          ACMASTER.CFG
  1371.  
  1372.          For use with ACMASTER.EXE   See UTILITY PROGRAMS on Page 31.
  1373.  
  1374.  
  1375.          ACF_MOVE.CTL
  1376.  
  1377.          For use with ACF_MOVE.EXE.  See MULTI-NODE OPERATIONS on Page 34.
  1378.  
  1379.                           ACFiles SysOp Documentation
  1380.                                     Page 23
  1381.  
  1382.  
  1383.  
  1384.          OTHER SETUP CONSIDERATIONS
  1385.          ─────────────────────────────────────────────────────────────────────
  1386.          The following  environment  variables  must  be  set  either  in your
  1387.          AUTOEXEC.BAT file or, within your BBS.BAT file or the ACF.BAT file.
  1388.  
  1389.          SET DSZLOG=C:\QUICKBBS\DSZ.LOG
  1390.                      or
  1391.          SET DSZLOG=C:\NODE1\DSZ.LOG
  1392.  
  1393.          DSZLOG is the full path and filename  to  your DSZ.LOG.  This MUST be
  1394.          set to  the  same directory as the CURRENT NODE  and  must  be  named
  1395.          DSZ.LOG.  Failure  to  have this set right will result in NO download
  1396.          counters/time ratios,  etc. to  be  updated.   Multi-node  operations
  1397.          pointing to the SAME PATH\DSZ.LOG will result in SHARE VIOLATIONS.
  1398.  
  1399.          If you  are multitasking then these variables may  be  set  within  a
  1400.          batchfile (BBS.BAT  or  the ACFILES.BAT file) inside of the DV window
  1401.          specific to the node in question rather than globally.
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.          INTERFACING ACFILES WITH THE BBS
  1408.          ─────────────────────────────────────────────────────────────────────
  1409.          Make a Type 15 (or Type 7 if  you  are  using QuickBBS 2.75 or above)
  1410.          that calls the door like the following:
  1411.  
  1412.           C:
  1413.           CD\ACFILES <c:\QuickBBS>
  1414.  
  1415.           -You may specify the path to the EXITINFO.BBS
  1416.  
  1417.          Simply put
  1418.  
  1419.             -the path when calling ACFiles.  Ex.  ACFILES C:\QUICKBBS
  1420.             -Trailing backslash is optional.
  1421.  
  1422.  
  1423.           EGA43      <---------  This statement is to switch to 43 line mode
  1424.           ACFILES                IF you have EGA/VGA. Use whatever comes with
  1425.           C:                     your video card!
  1426.           CD\QUICKBBS
  1427.              {call QuickBBS again}
  1428.  
  1429.          You are now ready to try it out.  Either run the BBS and call ACFiles
  1430.          with the  menu you have just created or go to the  ACFiles  directory
  1431.          and type ACFILES L (for Local access).
  1432.  
  1433.          If you  have  EGA  or  VGA, I'd suggest you have your batch file make
  1434.          your screen length 43/50 lines  upon  start  up. That way you can use
  1435.          all the lines yourself as well as viewing the file list properly when
  1436.          a remote is on-line.  ACFiles will figure out your  screen length for
  1437.          both remote and local.
  1438.  
  1439.                           ACFiles SysOp Documentation
  1440.                                     Page 24
  1441.  
  1442.  
  1443.  
  1444.          BATCHFILE CONFIGURATION
  1445.          ─────────────────────────────────────────────────────────────────────
  1446.          If a  batch  file FREQDOOR.BAT exists, then ACFiles will be triggered
  1447.          to display a [R]equest Door command  for  users.   ACFiles  will call
  1448.          Freqdoor.bat to run the door.  This is in case you like one of those.
  1449.          Moving Files - ACFiles
  1450.  
  1451.          MOVEFILE.BAT and COPYFILE.BAT allow total configurability  of how you
  1452.          MOVE/COPY files.   3  examples  are  given -MOVEFILE.BAT does nothing
  1453.          (will act like QuickBBS's Move  command),  TOZIP.BAT will convert all
  1454.          files to .ZIP, and SCANZIP.BAT will scan the files  being  moved  for
  1455.          Viruses and  convert  to  .ZIP  format.   USE  EXTREME  CAUTION  WHEN
  1456.          ALTERING THE MOVEFILE.BAT/COPYFILE.BAT files!!!
  1457.  
  1458.          MOVEFILE.BAT
  1459.  
  1460.          Called from ACFiles when the MOVE  command  is selected for the SysOp
  1461.          Command menu.  It is passed the following parameters:
  1462.  
  1463.          MOVEFILE.bat {filepath} {filename} {filename *W/O.EXT*} {.EXT ONLY}
  1464.  
  1465.               So let's say I'm moving a file TEST.ZIP from  area A2 (which you
  1466.               have configured  as  having  a  files  path of D:\BBS).  ACFiles
  1467.               would pass the following:
  1468.  
  1469.               MOVEFILE.BAT D:\BBS\ TEST.ZIP TEST ZIP
  1470.  
  1471.               Therefore you can check %1, %2, %3, and %4 in your batch file to
  1472.               do all sorts of things.
  1473.  
  1474.               Upon exiting, MOVEFILE.BAT  must  create  a file called FILENAME
  1475.               that contains the file's name.  This allows  you  to  change  to
  1476.               filename during a conversion from .PAK to .ZIP.  If the filename
  1477.               above was  not modified, then you could do ECHO %2.%3 >FILENAME.
  1478.               That would  put  the  name  TEST.ZIP  into  the  file  FILENAME.
  1479.               ACFiles will read this in and put that name  in  the file area's
  1480.               list.  Let's  say  we changed the extension to .PAK.  We'd do an
  1481.               ECHO %2.PAK >FILENAME and  QuickBBS  would  know that the file's
  1482.               name has been modified and will use it in the new file list.
  1483.  
  1484.               Look at TOZIP.BAT and SCANZIP.BAT for good examples.
  1485.  
  1486.          COPYFILE.BAT
  1487.  
  1488.          Used exactly like MOVEFILE.BAT, but called with the COPY command
  1489.          from the ACFiles SysOp menu.
  1490.  
  1491.  
  1492.          PRE-DOWN.BAT
  1493.  
  1494.          Called before  all downloads (if exists).  See MULTI-NODE  OPERATIONS
  1495.          on Page 34-35 for a complete description.
  1496.  
  1497.  
  1498.  
  1499.                           ACFiles SysOp Documentation
  1500.                                     Page 25
  1501.  
  1502.  
  1503.  
  1504.          DROP_DOS.BAT
  1505.  
  1506.          Selecting the  "Drop  to  DOS"  option  on the SysOp menu from within
  1507.          ACFiles calls this batchfile.   It  may  be  used  to invoke DOORWAY,
  1508.          PCANYWHERE, or any other remote DOS shell that you  wish  to  employ.
  1509.          Two parameters are passed: Baud Rate (%1) Comm Port and (%1).
  1510.  
  1511.               Example:
  1512.  
  1513.               @echo off
  1514.               DOORWAY %1 %2
  1515.  
  1516.  
  1517.          AFTERUP.BAT
  1518.  
  1519.          This batchfile  is  called immediately following a successful upload.
  1520.          It is used to scan files for a potential virus, convert the file to a
  1521.          specific archive format, include BBS comments/ads within the archive,
  1522.          etc.  Used in conjunction with  ACF_RET,  SCAN,  and  other utilities
  1523.          makes this a very powerful utility.
  1524.  
  1525.               Arguments:
  1526.  
  1527.               %1 - Path to File
  1528.               %2 - Filename
  1529.               %3 - Filename Without .EXT
  1530.               %4 - Extension of Filename (EXT without filename.)
  1531.  
  1532.          A complete, fully commented example is included with  ACFiles  making
  1533.          it usage "self-documented".
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.                           ACFiles SysOp Documentation
  1560.                                     Page 26
  1561.  
  1562.  
  1563.  
  1564.          SYSOP COMMANDS MENU
  1565.          ─────────────────────────────────────────────────────────────────────
  1566.          Hitting [*]  in any file area (for SysOp's) causes ACFiles to display
  1567.          a complete  sysop menu.  Here  you  can  Move  a  file(s),  Delete  a
  1568.          file(s), Hide/Unhide a file(s), or Edit a file(s)  description.   All
  1569.          of these  operations  may be performed on up to 100 tagged files at a
  1570.          time.
  1571.  
  1572.          [M] - Move Files
  1573.  
  1574.          The move command will ask for  files  to  move.   If  you have tagged
  1575.          files in  the file list using the selection bar  then  it  will  have
  1576.          these names  on  the  name prompt already.  In either case, enter the
  1577.          names of files you want to move  and  hit  Enter.   If the names were
  1578.          valid it will ask you which area you want to move  the file(s) to.  A
  1579.          complete list of file area names and their tags are displayed.  Enter
  1580.          the area  tag  associated  with  the  file  area you want to move the
  1581.          file(s) to.   ACFiles  will   then   move   the   files  calling  the
  1582.          MOVEFILE.BAT for any conversions you want.
  1583.  
  1584.          [X] - Copy File(s)
  1585.  
  1586.          The Copy  File  command works identically to the  Move  command,  but
  1587.          calls the batchfile COPYFILE.BAT.
  1588.  
  1589.          [D] - Delete File(s)
  1590.  
  1591.          Delete works in the same manner as above in enter the filenames.  Hit
  1592.          enter on  the  filenames  you want to delete and it will delete them.
  1593.          Space out the prompt and it will abort.
  1594.  
  1595.          [H] - Hide/Unhide Files
  1596.  
  1597.          Hide/Unhide works the same way with entering the filenames.  For each
  1598.          one entered it will tell you  if  it  is  currently hidden or not and
  1599.          then asks if you want it Hidden or Unhidden.  Hidden  files will only
  1600.          be displayed to those with SysOp access.  What may be helpful to know
  1601.          is that ACFiles does this by placing a @ in the front of the filename
  1602.          in the  area's  list.  This tells ACFiles (and it's utils) that these
  1603.          are hidden files.  This also  works  for  comment  lines, but comment
  1604.          lines can not be hidden from this menu.  You can  go  in and manually
  1605.          edit the list with an ASCII editor to do this.
  1606.  
  1607.          [E] - Edit Descriptions
  1608.  
  1609.          All files  entered  here  will  be displayed and you will be asked to
  1610.          edit the description.  Hit enter  after  it  is how you want it to be
  1611.          and that becomes the file's new description.
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.                           ACFiles SysOp Documentation
  1620.                                     Page 27
  1621.  
  1622.  
  1623.  
  1624.          [A] - Add Filename(s)
  1625.  
  1626.          This option  allows  you  to  add  a filename into the listing.  Upon
  1627.          hitting A it will search the  directory  for  any  files that are not
  1628.          listed in  the  FILES.BBS.  It'll display their filenames.   You  can
  1629.          then enter  in  the  filenames  you  want to add.  After entering the
  1630.          filenames to add it'll ask for  descriptions.   Hitting  enter on the
  1631.          descriptions skips the addition of the files.
  1632.  
  1633.          [V] - View Log File
  1634.  
  1635.          This lets  you view the log file.  This is useful  to  tell  who  has
  1636.          uploaded and downloaded throughout the day.
  1637.  
  1638.          [R] - Remove Log File
  1639.  
  1640.          This lets  the  sysop remove the log file.  Confirmation of answering
  1641.          Yes is required before it'll be deleted to keep away from accidents.
  1642.  
  1643.          [C] - Clear Tagged List
  1644.  
  1645.          Will clear the current Tagged List in preparation for more work.
  1646.  
  1647.          [F] - FILES.BBS Editor
  1648.  
  1649.          The FILES.BBS  of  the  current  area  will  be  displayed  when  the
  1650.          FILES.BBS editor  is  called.   Here  you  may TAG  files  using  the
  1651.          selection bar.  You will then be presented several options:
  1652.  
  1653.               [M]ove:   to Move the entry
  1654.               [C]opy:   to copy the entry
  1655.               [D]elete: to delete the entry
  1656.               [E]dit:   to edit the entry
  1657.               [I]nsert: to insert a line at the cursor position
  1658.  
  1659.          [L] - Long Desc. Edit (Database Areas Only)
  1660.  
  1661.          Similar to   [E]   (Edit   Desc.)   but   pertaining   only   to  the
  1662.          VERBOSE/EXTENDED files descriptions.
  1663.  
  1664.          [O] - OS Raw Directory
  1665.  
  1666.          This command  will allow you  to  view  the  Operating  System's  RAW
  1667.          directory listing of any given path.  ACFiles will prompt you for the
  1668.          FULL PATH and will then display the listing.  Using  this option will
  1669.          help you  locate  files  on  your  system  that  are not available to
  1670.          ACFiles as uploadable/downloadable  but  which  you  may  access  via
  1671.          ACFiles's ability to Upload/Download via ANY path.
  1672.  
  1673.          This is  a  VERY  powerful option and is available  to  ANYONE  whose
  1674.          Security Level is greater than, or equal to, the defined SysOp level.
  1675.          It is,  therefore,  recommended  that  CoSysOp  assignment be tightly
  1676.          controlled and monitored.
  1677.  
  1678.  
  1679.                           ACFiles SysOp Documentation
  1680.                                     Page 28
  1681.  
  1682.  
  1683.  
  1684.          [P] - PathEdit Files (Database Areas Only)
  1685.  
  1686.          This command  will  allow  you to edit the PHYSICAL path to a file(s)
  1687.          and is intended for use in Database  areas  only.   Because it is not
  1688.          necessary to maintain a copy of the file physically  in  every  area,
  1689.          you may list a file in several area's FILES.BBS and simply "point" to
  1690.          the path using ACFiles File Database Feature.
  1691.                                                   
  1692.          ON-LINE SYSOP KEYS
  1693.          ─────────────────────────────────────────────────────────────────────
  1694.          CTRL-LFTARROW will increase a user's time by 1 minute.
  1695.          CTRL-RGTARROW will decrease a user's time.
  1696.  
  1697.          Other keys work like QuickBBS's status bar commands.  PgDn will move
  1698.          through the different status bars.  F9 will display the available
  1699.          SysOp keys.  They should be self-explanatory.
  1700.  
  1701.          ALT-C calls ACFiles' internal split-screen chat.
  1702.          ALT-F to edit the user's FLAGS.  (Permanently changed)
  1703.          ALT-S to edit the user's Security Level.  (Permanently changed)
  1704.          ALT-T to edit the time instead of adding or subtracting it.
  1705.          ALT-G Sends Garbage to the user
  1706.          ALT-H Drops Carrier
  1707.  
  1708.          SYSOP UPLOAD/DOWNLOAD EXTENDED OPTION
  1709.  
  1710.          Anytime a user with SysOp SecLev Access selects [U]pload - [D]ownload
  1711.          they will first be presented with  an  [A]nywhere option.   This is a
  1712.          very POWERFUL (and potentially DANGEROUS) feature.   With this option
  1713.          the SysOp may specify the FULL PATH and download a file from ANYWHERE
  1714.          on the system.   It also allows the SysOp  to  prepare batchfiles and
  1715.          upload them directly into place.  ...   GIVE SYSOP ACCESS CAUTIOUSLY!
  1716.  
  1717.  
  1718.  
  1719.                           ACFiles SysOp Documentation
  1720.                                     Page 29
  1721.  
  1722.  
  1723.  
  1724.          CUSTOM ANSI/ASCII MENUS  (Registered Version Only)
  1725.  
  1726.          Upon Registering ACFIles you can create custom ANSI/ASCII screens for
  1727.          use with  ACFiles. If the ASCI/ANSI files below exist in your ACFiles
  1728.          directory, then ACFiles will use that screen as a "template" for your
  1729.          main screen menus
  1730.  
  1731.          Note as well that you can also  have  ACFSET.A?? and ACF.A??.So, here
  1732.          are the files you can have for templates:
  1733.  
  1734.             ACFMAIN.ASC  <- ASCII
  1735.             ACFMAIN.ANS  <- 25 Line ANSI
  1736.             ACFMAIN.A43  <- 43 Line ANSI        Main Menu
  1737.             ACFMAIN.A50  <- 50 Line ANSI
  1738.  
  1739.             ACFSET.ASC  <- ASCII
  1740.             ACFSET.ANS  <- 25 Line ANSI
  1741.             ACFSET.A43  <- 43 Line ANSI         "A" through "Z" Sets
  1742.             ACFSET.A50  <- 50 Line ANSI
  1743.  
  1744.             ACF.ASC  <- ASCII
  1745.             ACF.ANS  <- 25 Line ANSI
  1746.             ACF.A43  <- 43 Line ANSI            Specific Areas
  1747.             ACF.A50  <- 50 Line ANSI
  1748.  
  1749.             ACFSUB.ASC  <- ASCII
  1750.             ACFSUB.ANS  <- 25 Line ANSI
  1751.             ACFSUB.A43  <- 43 Line ANSI         Global Operation Sub-Menu
  1752.             ACFSUB.A50  <- 50 Line ANSI
  1753.  
  1754.          Control Codes:
  1755.  
  1756.          The following characters will produce substitutions in the ANSI/ASCII
  1757.          files.  Note  that  ACFiles  is  "smart"  and  won't  (theoretically)
  1758.          overwrite the data to the right of your control characters like most.
  1759.          Use the  enclosed  ACFMAIN.ANS as an example and let your imagination
  1760.          take over.
  1761.  
  1762.  
  1763.          The codes are:
  1764.          ASCII       KEY-COMBO       DESCRIPTION
  1765.          -------------------------------------------------------------------  
  1766.           001         CTRL-A         Area Name
  1767.           002         CTRL-B         Area Description
  1768.           003         CTRL-C         Area Tag (3-Character Format i.e. "A-0")
  1769.  
  1770.          Simply place  them  in  the  same order as their corresponding  parts
  1771.          appear  in the ACFiles Internal screens.
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.                           ACFiles SysOp Documentation
  1780.                                     Page 30
  1781.  
  1782.  
  1783.  
  1784.          UTILITY PROGRAMS:
  1785.          ─────────────────────────────────────────────────────────────────────
  1786.          ACMAINT.EXE
  1787.  
  1788.          This is  the  maintenance  program.  It reads in the area's lists and
  1789.          cleans them up a bit by making  the  first  letter  of  each  word in
  1790.          Upper-case, Like  This  Line  Is.   It  also  sorts   the   filenames
  1791.          underneath the   comment   lines.   This  should  cut  down  on  your
  1792.          maintenance.
  1793.  
  1794.          ACMASTER.EXE   (ACMASTER.CFG REQUIRED)
  1795.  
  1796.          This creates a human-readable  file of all the files and descriptions
  1797.          in your  file system.  The filename is defined in  ACMASTER.CFG,  as
  1798.          are the security levels for multiple allfiles listings.
  1799.  
  1800.          If you  run  ACMaster  then  you can now check for duplicate uploads.
  1801.          After upload,  ACFiles will  scan  the  master  list  for  the  newly
  1802.          uploaded file's  name.   If  it  exists  it'll mark  the  file  as  a
  1803.          duplicate by putting DUPLICATE FILE!! in the description.
  1804.          IF ACMASTER.HED  exists  (a  SysOp  created  ASCII  textfile)  it  is
  1805.          appended to and displayed at the top of the ACMASTER list.
  1806.  
  1807.               ACMASTER.CFG
  1808.  
  1809.               This file is used by ACMASTER.EXE to create multiple master file
  1810.               listings according  to   security   level.   The  ONLY  required
  1811.               parameter is  a single filename for the master  list.   In  this
  1812.               case, a  single  list  would  be  created  and accessible to all
  1813.               users.
  1814.  
  1815.                    Syntax: LISTNAME <SEC> <FLAGS>
  1816.  
  1817.                    EXAMPLE:
  1818.  
  1819.                    ADULT.TXT 10-90 DX-------
  1820.                    ALLFILE.TXT 500
  1821.  
  1822.               In the example above, the  file  ADULT.TXT  would be created for
  1823.               users with SecLev 10 through 90 with Flag D1  ON and ALLFILE.LST
  1824.               for users  with a SecLev of 500 or greater.  Flags may be in any
  1825.               order and are ignored if not specified. (X or 1=ON, - or 0=OFF)
  1826.  
  1827.  
  1828.          ACF_UPL.EXE
  1829.  
  1830.          This utility was provided for  those  who  wish  to include "Uploaded
  1831.          By:" lines, but who do not wish to use the File  Database  Option  of
  1832.          ACFiles.  It  should  be  run during maintenance and appends the user
  1833.          name DIRECTLY to the FILES.BBS  file.   For  this  reason, it will be
  1834.          available for viewing by ALL users and will not  be  affected  by the
  1835.          SecLev Upload  Viewing  option  in  ACFCONF.  If you use the FDB area
  1836.          option, then you will not need this utility.
  1837.  
  1838.  
  1839.                           ACFiles SysOp Documentation
  1840.                                     Page 31
  1841.  
  1842.  
  1843.  
  1844.          ACFIDX.EXE
  1845.  
  1846.          This utility  need only be run once, an only if you intend to operate
  1847.          ACFiles using the File Database  Feature  (recommended).   It  is run
  1848.          from the main ACFiles directory with no parameters and will build the
  1849.          initial .FDB indexes.
  1850.  
  1851.  
  1852.          PRIOR to  running ACFIDX, be sure that you have completed  your  file
  1853.          area configuration  in ACFCONF.EXE and listed any paths not contained
  1854.          in the file area configuration in ACFIDX.CTL.
  1855.  
  1856.          ACFIDX may  optionally  be called  with  AREA  TAGS  as  command-line
  1857.          parameters (i.e.  ACFIDX.EXE A0 A3 H8).  This will  cause  ACFIDX  to
  1858.          create .FDB  indexes  ONLY  for  those areas specified on the command
  1859.          line.  Default is ALL areas.
  1860.  
  1861.  
  1862.  
  1863.          FD2ACF.EXE
  1864.  
  1865.          Converts FileDoor-Style FILES.BBS's  to  ACFiles format.  The formats
  1866.          are 99% the same with the exception of the # Times  a  file  has been
  1867.          downloaded counter.  This will make the conversion.
  1868.  
  1869.          ACF_ADD.EXE  (Database Areas Only)
  1870.  
  1871.          ACF_ADD.EXE will  search your FILES.BBS' and compare them against the
  1872.          File Database Indexes for files NOT included in the indexes.  It will
  1873.          update the indexes for any occurrences  of  this nature.  If the area
  1874.          tag is passed as a command line parameter ACF_ADD  will  act  on that
  1875.          area only.  Default is all areas.
  1876.  
  1877.  
  1878.          ACF_OPT.EXE  (Database Areas Only)
  1879.  
  1880.          Over time, the order of files listed in FILES.BBS will not correspond
  1881.          to the  File  Database  Indexes  due to alphabetizing the lists, etc.
  1882.          This will slow the listings for  the  on-line  user.  Running ACF_OPT
  1883.          will scan  your  FILES.BBS',  compare them to the  index  files,  and
  1884.          reorder them for optimization where necessary.  Running ACF_OPT in an
  1885.          event on  a  weekly or monthly basis will insure the fastest response
  1886.          time for your ACFiles users.   If the area tag is passed as a command
  1887.          line parameter ACF_OPT will act on that area only.   Default  is  all
  1888.          areas.
  1889.  
  1890.          NOTE:  If  you  NEVER  re-arrange  your FILES.BBS (alphabetically, by
  1891.          subject matter, etc.) then you will not need to run this utility.
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.                           ACFiles SysOp Documentation
  1900.                                     Page 32
  1901.  
  1902.  
  1903.  
  1904.          ACF_OFF.EXE  (Database Areas Only)
  1905.  
  1906.          This does the same thing as ACF_OPT except it will also check
  1907.          to see if files are off-line or not in the FDBs.  This is useful
  1908.          for those  that  like  the  speed  of  FDB's  but  like  to use other
  1909.          utilities to manage them or if  they like deleting them during maint.
  1910.          and would like for it not to show it as being there  anymore.  If the
  1911.          area tag  is  passed  as a command line parameter ACF_OFF will act on
  1912.          that area only.  Default is all areas.
  1913.  
  1914.  
  1915.          ACF_RET.EXE
  1916.  
  1917.          This utility is used in conjunction  with  AFTERUP.BAT, MOVEFILE.BAT,
  1918.          and COPYFILE.BAT.  It is called as follows:
  1919.  
  1920.               ACF_RET <parm> [Message]
  1921.  
  1922.               Parameters:
  1923.  
  1924.               MSG       Echos a message to the user upon  return  to  ACFiles.
  1925.                         Used to  explain  delays and/or advise user of current
  1926.                         operation.  i.e.   "Thanks  for  the  Upload!", "VISUS
  1927.                         DETECTED - FILE DELETED!", etc.
  1928.  
  1929.               NAME      Used   to  rename  the  file  following   an   archive
  1930.                         conversion, etc.
  1931.  
  1932.               DELETE    Causes   ACFiles   to   NOT   update   FILES.BBS.   In
  1933.                         AFTERUP.BAT this  can  be  used following a virus scan
  1934.                         that results  in identification of  a  possible  virus
  1935.                         within the file.
  1936.  
  1937.               NODELETE  (Default) Updates FILES.BBS  with file description.
  1938.  
  1939.               NOCREDIT  Instructs  ACFiles  to  NOT  give credit for the file.
  1940.                         Can be used to  eliminate  credit  for files that were
  1941.                         found to contain a virus.
  1942.  
  1943.               CREDIT    (Default)  Restores user credit.
  1944.  
  1945.               HIDE      Hides upload from all users except users with
  1946.                         SysOp level access.
  1947.  
  1948.               NOHIDE    UnHides upload making it visible to all users.
  1949.  
  1950.               TIME <ratio>  Changes upload time multiplier for this file.
  1951.  
  1952.               PATH      Redefines the path in .FDB areas following movement of
  1953.                         the file in MOVFILE.BAT or AFTERUL.BAT.
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.                           ACFiles SysOp Documentation
  1960.                                     Page 33
  1961.  
  1962.  
  1963.  
  1964.          NEWDATE.EXE
  1965.  
  1966.          This utility  will  "touch"  files  and  change the date to "today's"
  1967.          date.  It can be used in AFTERUP.BAT,  MOVEFILE.BAT, COPYFILE.BAT, or
  1968.          anywhere you wish to touch file dates.
  1969.  
  1970.          LOGUPD.EXE
  1971.  
  1972.          If you have configured ACFiles to update download  counters  on-line,
  1973.          LOGUPD will  be  of  no  use  to  you (unless you wish to update your
  1974.          download counters based of FREQs  as  well).   LOGUPD  will  scan the
  1975.          ACFiles transfer log (or Binkley Log, Front Door  Log,  RA LOG, etc.)
  1976.          for downloads  (or  FREQS)  since  the  last  time LOGUPD was run and
  1977.          update the corresponding download counters in the FILES.BBS.
  1978.  
  1979.          LOGUPD.EXE will work on ANY logfile that uses the QuickBBS/Binkley/FD
  1980.          log format.  This means that  you  may  update  your file counters to
  1981.          include file requests from your mailer's logfile.  LOGUPD maintains
  1982.          an "index"  of each logfile in the ACFiles master  directory  in  the
  1983.          format <logfile>.LUD   (i.e. SYSTEM.LUD).  This file is maintained by
  1984.          LOGUPD to keep track of where it last conducted an update.
  1985.  
  1986.               USEAGE:  LOGUPD <path\logfilename>
  1987.  
  1988.  
  1989.          MULTI-NODE SPECIFIC OPERATIONS
  1990.  
  1991.          Besides the Node Configuration  section  of  ACFCONF.EXE, there are a
  1992.          few additional considerations when running ACFiles  in  a  Multi-node
  1993.          environment.
  1994.  
  1995.          DOS's SHARE.EXE  must  be  loaded.  Simply follow the instructions in
  1996.          your DOS manual.
  1997.  
  1998.          ACF_MOVE.EXE
  1999.  
  2000.          ACF_MOVE is intended to be run  during  the  PRE-DOWN batch interface
  2001.          for ACFiles.  This program merely moves the files  off  of the drives
  2002.          specified in  ACF_MOVE.CTL.   A  copy  of ACF_MOVE.CTL must reside in
  2003.          each node's directory making sure the path defined in acf_move.ctl is
  2004.          unique to  each  node.  This  will  ensure  that  there  will  be  no
  2005.          conflicts.  If  you  use  ACF_MOVE, you'll need to  use  CLEANDIR  or
  2006.          another means of removing the directory specified in acf_move.ctl
  2007.          so that you won't be consuming too much space.
  2008.  
  2009.               ACF_MOVE.CTL is  a simple ASCII control file which specifies the
  2010.               temporary directory for ACF_MOVE.EXE to place the files prior to
  2011.               downloading, and the drives  from  which  this  operation should
  2012.               take place.   A full self-documented example  is  included  with
  2013.               ACFiles.
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.                           ACFiles SysOp Documentation
  2020.                                     Page 34
  2021.  
  2022.  
  2023.  
  2024.          CLEANDIR.EXE
  2025.  
  2026.          Intended to  be  used  with  the  PRE-DOWN.BAT batchfile.  Clears the
  2027.          temporary directory of all files  following  a  successful  download.
  2028.          Equivalent to DEL *.*
  2029.  
  2030.  
  2031.          PRE-DOWN.BAT
  2032.  
  2033.          This batchfile, if it exists in the ACFiles master directory, will be
  2034.          executed prior to any download.  It is particularly useful for multi-
  2035.          node systems with CD-ROM(s) or Carousel/Cartridge type multi-disk CD-
  2036.          ROM systems.  Used in conjunction with ACF_MOVE.EXE and CLEANDIR.EXE,
  2037.          this batchfile will allow you to copy the files FROM  the CD-ROM to a
  2038.          temporary directory  on the Hard Drive, thus freing up the CD-ROM for
  2039.          immediate access by another node.
  2040.  
  2041.          A temporary directory should  be  created  for  each node to copy the
  2042.          files to.  i.e. C:\ACF_MOV1 for Node 1.
  2043.  
  2044.          An example of PRE-DOWN.BAT:
  2045.  
  2046.          @echo off
  2047.          ACF_MOV %1 %2
  2048.          CLEANDIR C:\ACF_MOV1
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.                           ACFiles SysOp Documentation
  2080.                                     Page 35
  2081.  
  2082.  
  2083.  
  2084.          COMMON QUESTIONS AND ANSWERS
  2085.          ─────────────────────────────────────────────────────────────────────
  2086.  
  2087.          1. Q.  ACFiles  isn't  updating  the  download counters or the user's
  2088.                statistics.  It also doesn't untag files after it transmits.
  2089.  
  2090.             A. This is a symptom of not  having  your  protocol's  log setting
  2091.                correct or could be you don't have the correct  log  format  or
  2092.                receive flags  right.   Check  to  make sure that your external
  2093.                protocol is creating a log and that you have an appropriate log
  2094.                format statement in ACFConf.  If you need assistance with this,
  2095.                don't hesitate  to  contact   me.   I'm  willing  to  give  you
  2096.                configurations for any protocol.
  2097.  
  2098.          2. Q. When moving/copying, it doesn't always get the name right after
  2099.                conversion. What is happening?
  2100.  
  2101.             A. You  are not returning the correct filename to ACFiles via. the
  2102.                ACF_RET program. If you need more help send  your  batch  to me
  2103.                and I'll get it patched up for you.
  2104.  
  2105.          3. Q. When a user is on-line  I  sometimes  don't  see the statistics
  2106.                information at the bottom of a file list or the file list looks
  2107.                strange as they scroll.
  2108.  
  2109.             A. This  is  not  an error.  ACFiles detects the  remote  system's
  2110.                screen length  and uses that.  So if it detects them to have 50
  2111.                lines and you only have  25 on your end then you will naturally
  2112.                be missing  some information.  The user will  see  the  screens
  2113.                just fine though.
  2114.  
  2115.          4. Q. What is an area tag???
  2116.  
  2117.             A. An  area  tag  is a 2-character I.D. for a file area instead of
  2118.                having to give ACFiles  a  path  all the time for moving files,
  2119.                etc.  It is the same key combination that you  would  do to get
  2120.                to the area.  So, area B5 would be Set B, Number 5.  The area's
  2121.                area tag  is  displayed at the top of the configured file areas
  2122.                in ACFConf as well as ACFiles.
  2123.  
  2124.          5. Q. When doing a file list I see ANSI codes.
  2125.  
  2126.             A. You don't have ANSI.SYS  installed.   Or, if you have a 50 line
  2127.                screen or  something  you  may  not have the  correct  ANSI.SYS
  2128.                involved.  Read  your  system's  manuals  for  more information
  2129.                there.
  2130.  
  2131.          6. Q. ACFiles isn't returning to the BBS with the correct time left.
  2132.  
  2133.             A. You are using a Type 7 that  doesn't read the EXITINFO.BBS back
  2134.                in or are failing to make sure the updated  EXITINFO.BBS  is in
  2135.                the BBS/Node  directory.   QuickBBS  2.75+  will work fine with
  2136.                Type 7.  Earlier versions should run Type 15.
  2137.  
  2138.  
  2139.                           ACFiles SysOp Documentation
  2140.                                     Page 36
  2141.  
  2142.  
  2143.  
  2144.          7. Q. When  running  ACFiles  under  the  File  Database  Option the
  2145.                listings seem to grow gradually slower over time.
  2146.  
  2147.             A. This happens when the FILES.BBS  and the .FDB are "out of sync"
  2148.                due to  constant  maintenance on the FILES.BBS  (alphabetizing,
  2149.                sub-grouping, etc).   Run  ACF_OPT which will optimize the .FDB
  2150.                database files to correspond with the FILES.BBSs.
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.          THAT'S ALL FOLKS
  2157.          ─────────────────────────────────────────────────────────────────────
  2158.          That should be it.  If you have any questions then please contact Ray
  2159.          Cole at 99:9100/8, 1:382/83, or  50:5512/0.  I'd be glad to hear from
  2160.          you!  If the demand is large enough I will create  a  Fido  echo  for
  2161.          ACFILES support.   Any responses to your netmail will be left on HOLD
  2162.          for your system to pick up from me.  I usually respond within 24
  2163.          hours but I am in college at the University of Texas and school is of
  2164.          the utmost importance ... so  please  be  patient.   Or  you may call
  2165.          (512)778-6246 at 300-14.4K HST and leave a message/page me there.
  2166.  
  2167.          Support may also be obtained in the RA_UTIL, QUICKBBS,  and  SUPERBBS
  2168.          echos as  well  as directly from the ACFiles Support/Beta Team Listed
  2169.          below:
  2170.  
  2171.          Larry Stultz                     PVT              9600 HST
  2172.           The Technical Connection      QuickBBS
  2173.            Wellborn, Florida
  2174.  
  2175.          Al Hays           1:363/89       407-438-7093     9600 HST/V32
  2176.           Mystic Pharos BBS             Remote Access      CD-ROM
  2177.            Orlando, Florida
  2178.  
  2179.  
  2180.          Gary Joneson      1:351/621      604-752-5249     9600 HST
  2181.           Shangri-La BBS                Remote Access      3 CD-ROMs
  2182.            Qualicum Beach, BC, Canada                      (2+ Gigs)
  2183.  
  2184.          Johnny Pulliam    1:382/77       512-259-4896     9600 HST
  2185.           Far Point Station             Remote Access
  2186.            Leander, TX
  2187.  
  2188.          Matt Chapin       1:382/66       512-328-8078     2400
  2189.           Eclectic Connection           Remote Access
  2190.            Austin, TX
  2191.  
  2192.          Tom Lane          1:382/91       512-282-3941     2400
  2193.           Flotom Enterprises BBS        Remote Access
  2194.            Austin, TX
  2195.  
  2196.  
  2197.  
  2198.  
  2199.                           ACFiles SysOp Documentation
  2200.                                     Page 37
  2201.  
  2202.  
  2203.  
  2204.          Steve Mitchell    1:14/643       701-594-9805     9600 CSP
  2205.           Magic's Corner                Remote Access
  2206.            Grand Forks AFB, ND
  2207.  
  2208.          Stephen Edgar     1:208/100      209-551-2258     9600 HST
  2209.           Modesto Hub                   Remote Access      CD-ROM
  2210.            Modesto, CA
  2211.  
  2212.          Ray Cole          1:382/83       512-778-6246     9600 HST
  2213.           The Auto Control BBS          QuickBBS           WORM
  2214.            Liberty Hill, TX
  2215.  
  2216.  
  2217.  
  2218.  
  2219.          Thanks for your support!
  2220.  
  2221.          Future programs  by  me  will be released in support for ACFiles.  DO
  2222.          THE RIGHT THING ... By registering  you will help me to be encouraged
  2223.          to continue developing ACFiles and keep it in the  forefront  as  the
  2224.          world's premiere BBS File System.
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.                           ACFiles SysOp Documentation
  2260.                                     Page 38
  2261.  
  2262.  
  2263.  
  2264.          REGISTRATION for  ACFiles v5.40  By Ray 'C'ole
  2265.          ──────────────────────────────────────────────────────────────────
  2266.  
  2267.  
  2268.          First Name, Last Name:  __________________________________________
  2269.  
  2270.                Mailing Address:  __________________________________________
  2271.  
  2272.                                  __________________________________________
  2273.  
  2274.                                  __________________________________________
  2275.  
  2276.          Voice Telephone Number: (______)________________________
  2277.  
  2278.          Data Telephone Number:  (______)________________________
  2279.  
  2280.          BBS Software Configuration: ______________________________________
  2281.  
  2282.          Are you a member of a network?     [  ] Yes     [  ] No
  2283.  
  2284.          If so, please give your primary address: _________________________
  2285.  
  2286.          Name of network: _________________________________________________
  2287.  
  2288.          Where did you hear about ACFiles?  _______________________________
  2289.  
  2290.           _________________________________________________________________
  2291.  
  2292.          Please list any comments, ideas, suggestions for improvement, or
  2293.          additional features that you would like to see included in future
  2294.          versions of ACFiles (PLEASE use additional pages if necessary <g>):
  2295.  
  2296.          __________________________________________________________________
  2297.  
  2298.          __________________________________________________________________
  2299.  
  2300.          __________________________________________________________________
  2301.  
  2302.          __________________________________________________________________
  2303.  
  2304.          __________________________________________________________________
  2305.  
  2306.          Registration Type and Amount Enclosed (check one):
  2307.  
  2308.          [  ] Non-Commercial - $15.00     [  ] Commercial - $30.00
  2309.  
  2310.  
  2311.  
  2312.          Make all checks payable to:       Ray Cole
  2313.          (US Currency only please!)
  2314.  
  2315.          Mail Registration to:             Ray Cole
  2316.                                            Route 6 Box 255
  2317.                                            Leander, TX  78641
  2318.  
  2319.  
  2320.  
  2321.                                     
  2322.  
  2323.